Nakama Authoritative Multiplayer

Autoritative = 権威的な、集権的な

Realtime vs Authoritative

こちらは単にメッセージをリレーするだけなので、マルチプレイ全体をサポートするには

host - client 方式になる。

ただし、リレーするだけなので検査無しで他のクライアントにメッセージが送られる

なので、曖昧or悪意あるメッセージがクライアントから送られることもある(つまりチートとか)

Realtime

検査なし

サーバーは stateless

サーバーは message をリレーするだけ

クライアント側でホスト-クライアント方式

Authoritative

サーバーサイドでコードを実行

サーバーに state を持つ

固定 tick rate でカスタムマッチロジックを実行

メッセージを検証

state が変更されたら 接続 peer に broadcast

できること

Asynchronous real-time authoritative

ペースの早いリアルタイムプレイ。高い tick rate が必要

Active turn-based

2人以上のプレーヤーが接続され、ターンベースのクイックマッチ

入力に即座に応答することが求められる。ただし real-time よりティックレートは少なくていい

Clash Royale, Stormbound

Passive turn-based

1プレイが数週間~

Words with Friends

Concepts

Match Handler

カスタムマッチロジックを実装するための6つの関数

Tick rate

一定時間入力のないプレイヤーをキックできたりする。

Match State

RAMメモリ領域に保存される、match に関する情報

Host Node

Minimum Match handler

hookのリスト

go でもかける

code: .lua

local M = {}

function M.match_init(context, setupstate)

local gamestate = {}

local tickrate = 10

local label = ""

return gamestate, tickrate, label

end

function M.match_join_attempt(context, dispatcher, tick, state, presence, metadata)

local acceptuser = true

return state, acceptuser

end

function M.match_join(context, dispatcher, tick, state, presences)

return state

end

function M.match_leave(context, dispatcher, tick, state, presences)

return state

end

function M.match_loop(context, dispatcher, tick, state, messages)

return state

end

function M.match_terminate(context, dispatcher, tick, state, grace_seconds)

return state

end

return M

Create authoritative matches

2つの方法

手動(RPC)

match_module名

initial_state

作成させる。

code: .lua

local nk = require("nakama")

local function create_match(context, payload)

local modulename = "pingpong"

local setupstate = { initialstate = payload }

local matchid = nk.match_create(modulename, setupstate)

-- Send notification of some kind

return matchid

end

nk.register_rpc(create_match, "create_match_rpc")

Matchmaker

match 作成関数を

code: .lua

local nk = require("nakama")

local function makematch(context, matched_users)

local modulename = "pingpong"

local setupstate = { invited = matched_users }

local matchid = nk.match_create(modulename, setupstate)

return matchid

end

nk.register_matchmaker_matched(makematch)

End Authoritative multiplayer

Authoritative match はプレイヤーが全員離脱しても自動的に終了しない。

ゲーム世界が進行している間、ユーザーが一時切断できるユースケースをサポートしている。

もしくはエラーが発生しても即座に終了する。

List match

アクティブなマッチを一覧表示する。

code: .lua

local nk = require("nakama")

local limit = 10

local isAuthoritative = true

local label = "skill=100-150"

local min_size = 0

local max_size = 4

local matches = nk.match_list(limit, isAuthoritative, label, min_size, max_size)

for _, match in ipairs(matches) do

nk.logger_info(("Match id %s"):format(match.match_id))

end

マッチ作成関数が呼び出されたとき、既に存在しているマッチから選んで返すパターン

code: .lua

local nk = require("nakama")

local function findorcreatematch(limit, label, min_size, max_size)

local matches = nk.match_list(limit, true, label, min_size, max_size)

if (#matches > 0) then

table.sort(matches, function(a, b)

return a.size > b.size;

end)

end

local modulename = "supermatch"

local initialstate = {}

local match_id = nk.match_create(modulename, initialstate)

return match_id

end

Search query

code: .lua

local query = "+label.mode:freeforall label.level:>10"

local matches = nk.match_list(limit, isauthoritative, label, min_size, max_size, query)

Runtime Code

Go と Lua がある。

どちらを使ってもかける。

基本的には Nakama module API を使いつつ

6つの match handler を実装するだけ